home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / telecomm / fido / gfreq15.lha / GFreq1.5 / Docs / GFreq_SW.doc < prev   
Text File  |  1994-09-23  |  16KB  |  375 lines
  1.  
  2.     GoldFreq version 1.4
  3.  
  4.     GoldFreq är shareware och copyright 1994 Jari Kanerva.
  5.     Jag kan nås på fidonet 2:201/411.73 eller 2:203/319.7
  6.     eller e-mail jari@p73.anet.bbs.bad.se
  7.     Snailmail
  8.         Jari Kanerva
  9.         Njurundagatan 6
  10.         162 29  VÄLLINGBY
  11.         SWEDEN
  12.  
  13.     Den senaste versionen av GoldFreq finns alltid att FileRequesta från
  14.     The Reptile House 2:203/424.0 Magic namn GoldFreq.
  15.  
  16.         Introduktion:
  17.     GoldFreq är en fidonetkompatibel filerequest server. Den har nodelist
  18.     support. Skickar netmail eller en respons fil till det freq:ande systemet.
  19.     Stöder mjuka länkar (SofLinks) Kollar att volymer finns innan dom används,
  20.     du slipper DOS-requestern "Stoppa in volym XX: i valfri enhet."
  21.     GoldFreq kan hantera pointer, magicfiles, updatefreq's, användarnivåer
  22.     password och mycket mer.
  23.  
  24.     Den registrerade versionen har dessutom bl a
  25.     Speciella passwords för sysopen och möjlighet att skapa statistik med
  26.     en medföljande statistiklistegenerator.
  27.  
  28.     Alla konfigurationsmöjligheter förklaras senare i den här textfilen.
  29.  
  30.     GoldFreq är shareware och keyfilen är kommersiell. GoldFreq får kopieras
  31.     fritt i icke komersiellt syfte (Alltså kopiera, sprid det och använd det.
  32.     Men tjäna inte pengar på det). Jag tar inget ansvar för felaktigheter som
  33.     programmet skapar eller som skapas av programmet på något sätt. Jag har
  34.     gjort allt för att det ska fungera så säkert som det bara går. Jag har
  35.     lagt lång tid på tester. men om några buggar (felaktigeheter) ändå skulle
  36.     finnas, meddela gärna mig.
  37.  
  38.     Keyfilen som du får när du registrerar är personlig och får inte spridas.
  39.  
  40.     GoldFreq är bara provad tillsammans med TrapDoor, men funkar lika bra
  41.     med andra liknande program.
  42.     GoldFreq behöver några argument när den startas.
  43.     Om du använder TrapDoor så lägg till raden
  44.     FREQUEST "GoldFreq %i %o %O \"%S\" %n %A" i TrapDoor.cfg eller
  45.     FREQUEST "GoldFreq %i %o %O \"%S\" %n %A c=<sökväg/cfgfil>" i TrapDoor.cfg
  46.     %i = Namnet på requestfilen.
  47.     %o = Namnet på .rlo-filen som trapdoor läser
  48.     %O = Sökvägen till ditt outbound
  49.     %S = Namnet på sysopen i det requestrande systemet.
  50.     %n = Fidoadressen till det requestrande systemet.
  51.     %A = AKA strängen
  52.     OBS Om du inte har programfilen GoldFreq i din path så måste du även ange
  53.     sökvägen till GoldFreq i TrapDoor.cfg.
  54.     Ex: FREQUEST "mail:bin/GoldFreq %i %o %O \"%S\" %n %A"
  55.  
  56.     För att kunna kolla om freqande noder är listade i nodelistan så
  57.     behöver GoldFreq dels en traplist kompilerad nodelista och dels
  58.     traplist.library version 5 eller högre.
  59.  
  60.     TrapDoor är copyright Maximilian Hantsch och Martin Laubach.
  61.  
  62.     Taglines, Syspass, FileAccounting, Allmagic, möjlighet att ange
  63.     flera filer med samma magicnamn och att använda 'wildcards' i
  64.     magicfilerna fungerar bara på den registrerade versionen.
  65.     Dessutom kan man med den oregistrerade versionen max requesta
  66.     3 filer åt gången.
  67.  
  68.     Registrering:
  69.     Inom Sverige. Sätt in 100 SKR på mitt postgiro nummer 836 86 57 - 6
  70.     Skriv ditt namn och adress och att det gäller registrering av GoldFreq.
  71.     Skriv också din fidonetadress så att jag kan skicka keyfilen.
  72.  
  73.     Utanför Sverige. Du kan antingen skicka en internationell betalninsorder
  74.     utställd på mig eller stoppa in 100 SKR i ett kraftigt kuvert och skicka
  75.     den till mig.
  76.     Adress:  Jari Kanerva
  77.              Njurundagatan 6
  78.              162 29  VÄLLINGBY
  79.              SWEDEN.
  80.     Glöm inte att skriva ditt namn och adress. Och att det gäller registrering
  81.     av GoldFreq. Och din fidonetadress.
  82.     Jag gör en fileattatch med din keyfile till angiven fidonet-adress.
  83.     Eller om det inte lyckas så UUEncodar jag den i ett netmail till dig.
  84.  
  85.     Keyfilen som du får när du registrerar är personlig och får inte spridas.
  86.     Om du säljer den får du inte behålla någon kopia av den själv.
  87.     Keyfilen GoldFreq.key ska ligga i samma dir som själva programmet GoldFreq
  88.     eller i Mail:
  89.  
  90.     Slutligen vill jag passa på och tacka
  91.     Kjell Cederfeldt för mycket hjälp, många bra ideer och betatestning.
  92.     Christian Carlsson för många bra ideer och betatestning. Och stort tålamod
  93.     med ett program som till en början inte ville starta på hans dator.
  94.  
  95. ===========================================================================
  96.  
  97.         Nu tittar vi på konfigurationsfilen.
  98.  
  99.         Keyword: SYSOP <Namn>
  100.     Här skriver du ditt eget namn.
  101.     Ex: SYSOP Jari Kanerva
  102.  
  103.         Keyword: NODE <nodenummer>
  104.     Här skriver du din fidonet adress. Om du använder fakenet så ska du
  105.     ändå skriva din riktiga 4 dimensionella adress.
  106.     Ex: NODE 2:203/319.7
  107.  
  108.         Keyword: SYSTEM <name>
  109.     Här skriver du namnet på din BBS.
  110.     Ex: SYSTEM The Cybers Heaven
  111.  
  112.         Keyword: (NO)FILEACC
  113.     Om du vill hålla räkning på hur många gånger varje fil har freqqats.
  114.     Det skrivs även i netmailet eller rspfilen.
  115.     Den kräver ACCPATH <dir>
  116.     Detta fungerar bara på den registrerade versionen.
  117.     Ex: FILEACC
  118.  
  119.         Keyword: (NO)ACCPATH <dir>
  120.     Om du vill hålla räkning på hur mycket olika noder och pointer freqar
  121.     från dig. Så ska du välja en dir där GoldFreq kan ha sina accounting
  122.     filer.
  123.     Ex: ACCTPATH  Mail:GFreq/Accounts
  124.  
  125.         Keyword: (NO)LOGFILE <file>
  126.     Om du vill använda en logfil så ska du här ange vilken fil du vill
  127.     använda.
  128.     Ex: LOGFILE Mail:GFreq/GFreq.Log
  129.  
  130.         Keyword: (NO)NODELIST <dir>
  131.     Om du vill kunna använda "NOUNLISTED" så behövs en traplist-kompilerad
  132.     nodelista. Här skriver du sökvägen till biblioteket där nodelistan
  133.     finns.
  134.     Ex: NODELIST Mail:Nodelist
  135.  
  136.         Keyword: DATABASE <dir>
  137.     Det här är en dir för GoldFreq's filer som den använder för internt
  138.     bruk. Behövs för bl a SYSPASS.
  139.     Ex: DATABASE mail:GFreq/Database
  140.  
  141.         Keyword: WORKDIR <dir>
  142.     Här skriver du var GoldFreq ska lägga sina temporära filer.
  143.     Ex: WORKDIR T:
  144.  
  145.         Keyword: (NO)LOCALMSG
  146.     Skicka ett netmail till dom som freqar filer. Med bl a resultat från
  147.     filerequesten.
  148.     Ex: LOCALMSG
  149.  
  150.         Keyword: (NO)RSP
  151.     Skicka en respons fil med resultaten från filerequesten. I stället för ett
  152.     netmail.
  153.     Ex: RSP
  154.  
  155.         Keyword: (NO)HEADER <file>
  156.     Brevhuvud att använda till netmailet eller rsp-filen. Om du vill använda
  157.     sådana så borde du även skiva ett brevhuvud. Innehållande en kort
  158.     berättelse om varifrån filerna kommer.
  159.     Ex: HEADER Mail:GFreq/GFreq.Header
  160.  
  161.         Keyword: (NO)FIRSTCALL <file>
  162.     Om du vill skicka ett speciellt brev till dom som freqar första gången.
  163.     För att exempelvis berätta lite om ditt system och vad som gäller där.
  164.     Samtidigt ska du välja en fil att hämta texten från.
  165.     Ex: FIRSTCALL Mail:GFreq/textfiles/FirstTime.TXT
  166.  
  167.         Keyword: (NO)TAGS <file>
  168.     Säg åt GoldFreq att du vill använda klotterrader (taglines). Och
  169.     berätta samtidigt vilken fil dom ska hämtas från. Om det i den inlästa
  170.     raden finns "\n" så blir det en ny rad i brevet.
  171.     Detta fungerar bara på den registrerade versionen.
  172.     Ex: TAGS Mail:Gfreq/Tags
  173.  
  174.         Keyword: (NO)SYSPASS <password/file>
  175.     Det här är ett speciellt password för sysopen. Genom att använda det
  176.     här kan han/hon hämta filer som inte finns i bibliotek som är
  177.     specifierade i GoldFreq.cfg. Och även hämta filer från system som
  178.     normalt inte skulle få hämta något.
  179.     I FReq-filen ska man då skriva:
  180.     På första raden skriver man: SYSPASS <password> (Ska alltså vara
  181.     passwordet)
  182.     Därefter är det bara att antingen skriva filerna som vanligt om dom
  183.     finns i GoldFreq's normala sökväg för filer (MAGIC eller DIRECTORY)
  184.     och om dom inte finns där så skriver man hela sökvägen till filen.
  185.     Man kan antingen välja ett password som gäller hela tiden eller skriva
  186.     namnet och sökvägen till en fil där det finns flera passwords. Om man
  187.     väljer en fil så kan varje password bara användas en gång. Därefter
  188.     markerar GoldFreq den som använd och det är nästa som gäller. Uppifrån
  189.     och ner. GoldFreq skriver ett mellanslag före passwordet i filen för
  190.     att markera att den är använd. Sedan får man editera filen manuellt för
  191.     att kunna använda passworden igen. När passworden är slut så är dom.
  192.     Efter tre misslyckade försök att använda SYSPASS så läggs en fil i
  193.     diren som du specifierat som DATABASE. Den filen heter NOSYSPASS. Och
  194.     måste tas bort manuellt. Så länge den finns där så är SYSPASS låst.
  195.     Om man skickar en eller två felaktiga SYSPASS och sen en korrekt så
  196.     börjar räkningen om. Och man får tre nya chanser.
  197.     Detta fungerar bara på den registrerade versionen.
  198.     Ex cfg: SYSPASS Mail:GFreq/PassWords
  199.     Ex cfg: SYSPASS Mitt_password_är_hemligt
  200.     Ex Freq: SYSPASS Mitt_password_är_hemligt
  201.              s:startup-sequence
  202.  
  203.         Keyword: (NO)FAILSYSPASS <file>
  204.     Sökvägen till textfil att stoppa in i netmail till dom som försöker
  205.     använda SYSPASS men misslyckas.
  206.     Ex: FAILSYSPASS mail:GFreq/Textfiles/FailSys.TXT
  207.  
  208.         Keyword: (NO)POINTS
  209.     Tillåt pointer att hämta filer.
  210.     Ex: POINTS
  211.  
  212.         Keyword: (NO)FAILPOINT <file>
  213.     Sökvägen till textfil att stoppa in i netmail till dom pointer som inte
  214.     fick några filer om NOPOINT används.
  215.     Ex: FAILPOINT mail:GFreq/Textfiles/Point.TXT
  216.  
  217.         Keyword: (NO)UNLISTED
  218.     Tillåt system som inte är listade i nodelistan eller eventuell
  219.     pointlista att hämta filer.
  220.     Ex: UNLISTED
  221.  
  222.         Keyword: (NO)FAILUNLISTED <file>
  223.     Sökvägen till textfil att stoppa in i netmail till dom olistade system
  224.     som inte fick några filer. Om NOUNLISTED används.
  225.     Ex: FAILUNLISTED Mail:GFreq/Textfiles/Unlisted.TXT
  226.  
  227.         Keyword: (NO)ONLYKNOWN
  228.     Tillåt bara system som är listade med ALLOWNODE att hämta filer.
  229.     Ex: ONLYKNOWN
  230.  
  231.         Keyword: (NO)FAILONLYKNOWN <file>
  232.     Sökvägen till textfil att stoppa in i netmail till dom system som inte
  233.     finns i ALLOWNODE listan. Om ONLYKNOWN används.
  234.     Ex: FAILONLYKNOWN Mail:GFreq/Textfiles/Security.TXT
  235.  
  236.         Keyword: EXCLUDE <node>
  237.     Förbjud vissa specifierade system från att hämta filer. Du kan använda
  238.     "wildcards" (*)
  239.     Ex: EXCLUDE 1:234/567.8
  240.     Ex: EXCLUDE 55:100/*
  241.  
  242.         Keyword: (NO)FAILEXCLUDE <file>
  243.     Sökvägen till textfil att stoppa in i netmail till dom system som inte
  244.     får hämta filer för att dom finns i EXCLUDE listan.
  245.     Ex: FAILEXCLUDE Mail:GFreq/Textfiles/Exclude.TXT
  246.  
  247.         Keyword: (NO)BEEP
  248.     Säg åt GoldFreq att pipa och blinka skärmen för att tala om för dig att
  249.     det är en filerequest på gång.
  250.     Ex: BEEP
  251.  
  252.         Keyword: SCREEN <pubscreen>
  253.     Specifiera allmän skärm att använda till till GoldFreq's fönster.
  254.     (WB 2.04+) Om du tänker använda TrapDoor's almänna skärm så måste du
  255.     skriva in SCREENMODE PUBLIC i TrapDoor.cfg
  256.     Ex: SCREEN TrapDoor
  257.  
  258.         Keyword: SCREENPOS <pos> <pos>
  259.     Skriv in var du vill ha övre vänstra hörnet av GoldFreq's fönster.
  260.     Ex: SCREENPOS 100 25
  261.  
  262.         Keyword: (NO)QUIET
  263.     Säg åt GoldFreq att vara tyst Och inte öppna något fönster.
  264.     Ex: QUIET
  265.  
  266.         Keyword: (NO)SCREENTOFRONT
  267.     Flyttar fram skärmen som GoldFreq öppnar sitt fönster på. Funkar bara
  268.     om du har valt NOQUIET.
  269.     Ex: SCREENTOFRONT
  270.  
  271.         Keyword: (NO)DEFCOMMENT <desc>
  272.     Skriv filebeskrivning att använda om det saknas beskrivning i
  273.     "filecomment".
  274.     Ex: DEFCOMMENT No File Description Available :-(
  275.  
  276.         Keyword: (NO)FISH
  277.     För dom som använder Fish CD. Där beskrivningen ligger i en .pi fil i
  278.     samma dir som den egentilga filen. Men först letas alltid efter filecomment.
  279.     Ex: FISH
  280.  
  281.         Keyword: (NO)AMINET
  282.     För dom som har AmiNet där beskrivningarna ligger i en .readme fil.
  283.     Men först letas alltid efter filecomment.
  284.     Ex: AMINET
  285.  
  286.         Keyword: (NO)PRODUCT-INFO
  287.     Om inte filecomment hittas så leta efter filen Product-Info inne i arkivet.
  288.     Ex: PRODUCT-INFO
  289.  
  290.         Keyword: PASSDEFSEND <file>
  291.     Skriv en fil att skicka med alla lyckade fil requestrar.
  292.     Max 6 st.
  293.     Ex: PASSDEFSEND Files:Lokala/Text/NewFiles.lha
  294.  
  295.         Keyword: FAILDEFSEND <file>
  296.     Skriv en fil att skicka med alla freqar som inte passerade
  297.     säkerhetskollen.
  298.     Max 6 st.
  299.     Ex: FAILDEFSEND Files:Lokala/Text/BBSRules.lha
  300.  
  301.         Keyword: (NO)MAXBYTES
  302.     Sätt hur många bytes som får hämtas per filerequest.
  303.     Ex: MAXBYTES 10m  (10 Mb = 10 * 1024 * 1024 bytes)
  304.     Ex: MAXBYTES 50k  (50 Kb = 50 * 1024 bytes)
  305.     Ex: MAXBYTES 500b (500 bytes)
  306.     Ex: MAXBYTES 1254 (1254 bytes)
  307.  
  308.         Keyword: (NO)MAXFILES
  309.     Sätt hur många filer som får hämtas per filerequest.
  310.     Ex: MAXFILES 10
  311.  
  312.         Keyword: MAXLEVEL <level> FILES <files> BYTES <bytes>
  313.     Möjlighet att använda olika maxbytes och maxfiles för olika användar-
  314.     nivåer.
  315.     Ex: MAXLEVEL 2 FILES 20 BYTES 10m
  316.  
  317.         Keyword: ALLOWNODE <node> [LEVEL/ONLY <level>]
  318.     Specifiera vilka system som får hämta filer när ONLYKNOWN används
  319.     och/eller ge systemen olika användarnivåer. Om en node finns listad
  320.     under ALLOWNODE så görs inga ytterligare säkerthetskollar på det systemet.
  321.     Du kan ex sätta EXCLUDE 1:234/* för att ange att noder från net 1:234 inte
  322.     ska få hämta filer. Sen kan du skriva ALLOWNODE 1:234/567.5 för att ange
  323.     att just den pointen får hämta filer.
  324.     System med LEVEL 5 får hämta magicfiles och areor level 0-5.
  325.     System med ONLY 6 får bara hämta magicfiles och areor level 6.
  326.     Ex: ALLOWNODE 1:123/456.0 LEVEL 5
  327.     Ex: ALLOWNODE 1:123/456.8 ONLY 5
  328.     Ex: ALLOWNODE 2:203/319.7
  329.  
  330.         Keyword: (NO)DEFPOINTLEVEL <num>
  331.     Sätt default nivå för pointer som freqqar.
  332.     Ex: DEFPOINTLEVEL 1
  333.  
  334.         Keyword: (NO)DEFNODELEVEL <num>
  335.     Sätt default nivå för noder som freqqar.
  336.     Ex: DEFNODELEVEL 2
  337.  
  338.         Keyword: (NO)UPDATE
  339.     Tillåt update-requests. Hämta fil efter datum +yymmdd.
  340.     Fil före datum -yymmdd.
  341.     Skrivs i FReq-filen efter namnet på filen som det gäller, med ett
  342.     mellanslag mellan.
  343.     Ex: UPDATE
  344.  
  345.         Keyword: ALLMAGIC <name> <file>
  346.     Definera magiska filnamn som alla får hämta. Alltså även dom som inte
  347.     klarar säkerhetskollen. Utom dom system som finns i EXCLUDE listan.
  348.     Detta fungerar bara på den registrerade versionen.
  349.     Ex: ALLMAGIC NEWFILES Files:Lokala/Text/NewFiles.lha
  350.  
  351.         Keyword: MAGIC <name> <file> [<level><password>]
  352.     Definera dom magiska filerna. Det går att välja användarnivå som behövs
  353.     för att hämta dom och/eller speciella passwords för dom. Passwordet ska
  354.     i FReq-filen stå efter filen den gäller, med ett mellanslag mellan.
  355.     Det går med den registrerade versionen även att använda "wildcards" (*).
  356.     Då skickas den nyaste filen som matchar namnet.
  357.     Filer som finns under ALLMAGIC behöver inte sättas under MAGIC.
  358.     Ex: MAGIC FILES Files:Lokala/Text/AllFiles.lha
  359.     Ex: MAGIC Spot Files:Lokala/Utils/spot.lha PASSWORD WHO_KNOWS LEVEL 5
  360.     Ex: MAGIC BARNEY Files:ADS/AdsFido/BARNEY* LEVEL 1
  361.     Ex: MAGIC GFreq Files:Lokala/Utils/GFreq*
  362.     Man kan även på den registrerade versionen skriva flera filer med samma
  363.     MAGIC-namn. Då skickas alla filer som har samma MAGIC-namn.
  364.     Ex: MAGIC Spot Files:Lokala/Utils/SPOT13.lha
  365.     Ex: MAGIC Spot Files:Lokala/Utils/SPOT13p.lha
  366.     Då får den som freqar båda filerna.
  367.  
  368.         Keyword: DIRECTORY <dir>
  369.     Definera direr där GoldFreq ska leta efter filer som freqqas. Det går
  370.     att använda passwords och användarnivåer precis som med MAGIC.
  371.     Ex: DIRECTORY Files:Lokala/Diffar
  372.     Ex: DIRECTORY Files:SKY/Shi_Tns PASSWORD Amiga LEVEL 5
  373.     Ex: DIRECTORY Files:ADS/AdsARexx LEVEL 4
  374.     Ex: DIRECTORY Files:ADS/AdsComm PASSWORD !!--
  375.